home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / multimedia / tvmore13.lha / TVMore.DOC < prev    next >
Text File  |  1993-12-06  |  37KB  |  944 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                                              
  8.                           W E L C O M E    T O                
  9.                                                               
  10.                                                               
  11.                                  'TVMore'                     
  12.                                                               
  13.                    A Text Viewer with MultiMedia support      
  14.                     (for OS1.x , OS2.x & OS3.x systems)       
  15.                                                               
  16.                                                               
  17.  
  18.  
  19.  
  20.                     Copyright 1993, MIKE HURT SOFTWARE!
  21.                             (all rights reserved)
  22.  
  23.  
  24.                                                                              
  25.  
  26.  
  27.     Table of Contents:
  28.     ------------------
  29.  
  30.       I - Introduction (F1)
  31.           a) What is it?
  32.  
  33.      II - Disclaimer (F2)
  34.  
  35.     III - Installation (F3)
  36.           a) What you should have received
  37.           b) System requirements
  38.           c) Installing
  39.           d) Custom editor
  40.  
  41.      IV - Reading Text (F4)
  42.           a) Keyboard shortcuts
  43.  
  44.       V - MultiMedia (F5)
  45.           a) Picture
  46.           b) Sound
  47.           c) Palettes
  48.           d) Music
  49.           e) Animation
  50.  
  51.      VI - Registration (F6)
  52.  
  53.     VII - Changes (F7)
  54.  
  55.    VIII - Final Note (F8)
  56.  
  57.  
  58.  
  59.  
  60.                                                                              
  61.  
  62. .bm 01,
  63.   Introduction:
  64.   -------------
  65.  
  66.     What is it?
  67.     -----------
  68.  
  69.       A text reader is a program that allows easy access to text files, also
  70.       called documents, for online reading.  Each text reader has a different
  71.       layout and control sequence, however, 'TVMore' includes many of the
  72.       more popluar keyboard shortcuts and interfaces which should make
  73.       'TVMore' intuitive and easy to use.  'TVMore' is small, just under 92K,
  74.       and incorporates many features such as; programmable book marks,
  75.       graphics (pictures & animations), sound (sound & music), multiple
  76.       palettes, syncronized sound (animations), syncronized events
  77.       (animations), and a standard intuition interface for portibility &
  78.       compatibility.
  79.  
  80.  
  81.  
  82.  
  83.                                                                              
  84.  
  85. .bm 02,
  86.   Disclaimer:
  87.   -----------
  88.  
  89.     MIKE HURT SOFTWARE!  IN NO WAY WHATSOEVER (INCLUDING EXPRESS OR
  90.     IMPLIED) WARRANTS, OR IS RESPONSIBLE FOR THE USE/MISUSE OF THIS
  91.     SOFTWARE PROGRAM OR RELATED MATERIALS (GRAPHICS, SOUND, SOUND
  92.     TRACKER MODULES, ETC.).  ANY DAMAGES RESULTING FROM THE USE OF
  93.     THIS PRODUCT WILL BE AT USERS RISK.  MIKE HURT SOFTWARE!  HOLDS
  94.     NO AFFILIATION WITH ANY OTHER COMPANY LISTED WITHIN THIS DOCU-
  95.     MENT; ALTHOUGH MENTION OF SUCH COMPANIES WITHIN THIS DOCUMENT IS
  96.     PROVIDED ONLY AS A COURTESY.
  97.  
  98.     MIKE HURT SOFTWARE!  EXCLUSIVELY HAS THE RIGHT TO CHANGE, DELETE
  99.     OR APPEND ANY PORTION OF THIS DOCUMENT, AND/OR, BUT NOT EXCLUDING,
  100.     ANY PROGRAM SOURCE CODE(S),  OBJECT CODE(S),  DOCUMENTATION,
  101.     EXAMPLE(S), PROGRAM ICON(S) AND/OR GRAPHIC(S) DEVELOPED BY MIKE HURT
  102.     SOFTWARE! FOR EXCLUSIVE USE BY "TVMORE", WITHOUT PRIOR WRITTEN NOTICE.
  103.     NO, PORTION OF "TVMORE" (DOCUMENTATION OR ABOVE  MENTIONED  MATERIALS)
  104.     MAY BE DUPLICATED IN ANY WAY, SHAPE OR FORM, INCLUDING ELECTRONIC
  105.     TRANSLATION,  WITHOUT WRITTEN PERMISSION FROM MIKE HURT SOFTWARE!
  106.     THIS IS A SHAREWARE PRODUCT.
  107.  
  108.     REGISTERED USER'S OF THIS PRODUCT WILL RECEIVE FREE SOFTWARE
  109.     UPDATES WHEN AVAILABLE (FOR THE PRICE OF SHIPPING & HANDLING PLUS
  110.     STORAGE MEDIA & LABELING).  THESE UPDATES INCLUDE SOFTWARE FIXES,
  111.     ADDITIONAL PROGRAM FEATURES AND USER SPECIFIED REQUESTS.
  112.  
  113.     "TVMORE" (DOCUMENTATION AND EXAMPLES) ARE COPYRIGHTED 1993 MIKE HURT
  114.     SOFTWARE!;  ALL RIGHTS ARE RESERVED.
  115.  
  116.     ADDITIONAL IDEAS CAN BE SUBMITTED TO THE FOLLOWING ADDRESS:
  117.  
  118.  
  119.                                               MIKE HURT SOFTWARE!
  120.                                               c/o TextReader2.0
  121.                                               dept Requests/Bugs
  122.                                               8608 Cotswald Drive
  123.                                               Louisville KY 40258
  124.  
  125.  
  126.  
  127.  
  128.                                                                              
  129.  
  130. .bm 03,
  131.   Installation:
  132.   -------------
  133.  
  134.     What you should have received
  135.     -----------------------------
  136.  
  137.     The following files are present within 'TVMore' release v1.0:
  138.  
  139.         (The 'TVMore' software)
  140.         TVMore
  141.         TVMore.info
  142.         TVMore.editor
  143.  
  144.         (The Documentation)
  145.         TVMore.DOC
  146.         TVMore.DOC.info
  147.         ReadMe.first!
  148.         ReadMe.first!.info
  149.  
  150.         (The installation software)
  151.         TVInstall
  152.         TVInstall.info
  153.         SI
  154.  
  155.         (The 'SnowDragon' storybook example)
  156.         SnowDragon
  157.         SnowDragon.info
  158.         SnowDragon.pic
  159.  
  160.         (The 'Phorohacos' animation example)
  161.         Phorohacos.DOC
  162.         Phorohacos.DOC.info
  163.         Phorohacos.map
  164.         Phorohacos.anim
  165.  
  166.         (The 'Camptosaurus' animation example)
  167.         Camptosaurus.DOC
  168.         Camptosaurus.DOC.info
  169.         Camptosaurus.map
  170.         Camptosaurus.anim
  171.  
  172.         (The 'Catalog' example)
  173.         Products.DOC
  174.         Products.DOC.info
  175.         TVMore.title
  176.         TVMore.pic
  177.         AnsiPainter.pic
  178.  
  179.  
  180.  
  181.     System Requirements:
  182.     --------------------
  183.  
  184.       'TVMore' was tested on an A2000 (running 1.3 & 2.0) & an A4000
  185.       (running 3.0).
  186.  
  187.       'TVMore' requires at least 512K of memory.  If graphics and sounds
  188.       are used, depending on the document, various amounts of FAST (and/or)
  189.       CHIP ram will be required.  'TVMore' will open it's window upon another
  190.       screen (such as 'WorkBench'), by default, thus saving valuable CHIP
  191.       memory by not opening it's own custom screen.  However, an eight (8)
  192.       color custom screen can be toggled on/off, each time, by pressing the
  193.       R-Amiga C keys simultaneously.  Each time the mouse is clicked outside
  194.       of the 'TVMore' window (the window was Deactivated) the original screen
  195.       colors will be restored, likewise, whenever the mouse is clicked
  196.       (on/or) inside the 'TVMore' window (the window was Activated), the
  197.       colors used by the document (if any) will be restored.  This allows the
  198.       restoring of the original palette when returning back to the system
  199.       for other tasks.  Whenever 'TVMore' is exited, the original screen
  200.       colors will be restored.
  201.  
  202.       (A2000, A4000 & WorkBench are trademarks of CBM inc.)
  203.  
  204.  
  205.  
  206.     Installing:
  207.     -----------
  208.  
  209.       'TVMore' can be installed on your system by double clicking the
  210.       installation icon (TVInstall).
  211.  
  212.       This will copy the 'TVMore' program to your current 'c:' directory.
  213.  
  214.       Optional installation files include the 'TVMore.editor' file.
  215.  
  216.  
  217.  
  218.     Custom Editor:
  219.     --------------
  220.  
  221.       Any text file that is currently loaded into 'TVMore' can be edited
  222.       by pressing the "R-Amiga W" keys simultaneously.  This will launch
  223.       the 'ED' (system software) program by default.  If this is not the
  224.       editor of choice, place the name of the editor that you would like
  225.       to use in the 'TVMore.editor' file, then copy this file into the
  226.       same directory as 'TVMore' (or) into your 's:' directory.
  227.  
  228.       ('ED' is copyrighted CBM inc.)
  229.  
  230.  
  231.  
  232.  
  233.                                                                               
  234.  
  235. .bm 04,
  236.   Reading Text:
  237.   -------------
  238.  
  239.     Reading text is easy, from the CLI enter:
  240.  
  241.     TVMore "<textfile>"
  242.  
  243.     This will load the file "<textfile>" directly into 'TVMore'.  If
  244.     the "<textfile>" does not exists, is unavailable (in use), or cannot
  245.     be loaded (not enough free memory), or 'TVMore' was started without
  246.     specifying which "<textfile>" to load, then you will be prompted for
  247.     the file name via a 'Select a file to View' requestor.  If you select
  248.     <CANCEL> from the requestor, then 'TVMore' will exit without loading a
  249.     document.  However, if a document is already present, and the requestor
  250.     is <CANCEL>ed, then you will be returned to the current document.
  251.  
  252.  
  253.     You can also specify the 'Default Tool' found with an icons 'Information'
  254.     to be 'TVMore' (without any quotes).  Now, whenever this icon is double
  255.     clicked, the system will attempt to load 'TVMore' to view the text file
  256.     (specified by the name of the icon); provided 'TVMore' was installed
  257.     on your system.
  258.  
  259.                                 ----------
  260.  
  261.     To define a book mark within a document, use the ".bm " command; book
  262.     mark.  The syntax is: ".bm b#,<description>".  Where "b#" is a two
  263.     digit number (1-10 corrosponding to the F1-F10 function keys) and
  264.     "<description>" is a short description of the "book marked" section.
  265.  
  266.     For example:
  267.  
  268.     .bm 01,Introduction
  269.  
  270.     Will be "jumped" to whenever the F1 key is pressed.
  271.  
  272.     Note:  The '.bm ' document command should always begin in column #1
  273.     of the document.
  274.  
  275.                                 ----------
  276.  
  277.     To dynamically set a "Book Mark" for a particular document, press the
  278.     R-Amiga key (hold it down), then press the function key (F1-F10), then
  279.     release them both.  Now, whenever that particular function key is pressed
  280.     by itself, the document will be "jumped" to that location.
  281.  
  282.     To free a dynamic "Book Mark", press the L-Amiga key (hold it down), then
  283.     press the function key to clear (F1-F10), then release them both.
  284.  
  285.     Note:  The dynamic "Book Mark" will override any document book mark
  286.     commands '.bm '.  Dynamic "Book Marks" are automatically cleared when
  287.     a new document has been loaded.
  288.  
  289.                                 ----------
  290.  
  291.     To save your current location within any document that you are reading,
  292.     press the R-Amiga M keys simultaneously.  Now, whenever that document
  293.     is reloaded into 'TVMore', 'TVMore' will "remember" the saved location
  294.     for that particular document and start displaying text & graphics from
  295.     there.
  296.  
  297.     Note: Since this current location is kept in the same directory as the
  298.     document, (in a file with the same name as the current document but with
  299.     .pmark" suffix attached to the end of it & will be deleted automatically
  300.     when it's reoaded into 'TVMore') each document can have it's own "current
  301.     restart file";  if this location is a device such as a floppy (or) hard
  302.     disk, then this information will survive a system reboot.
  303.  
  304.                                 ----------
  305.  
  306.     Two special Book Mark commands exist for picture "illustrations" only.
  307.     These commands allow clicking on any picture (other than an animation)
  308.     that is currently being displayed on the 'TVMore' window.  This will
  309.     result in 'TVMore' automatically playing (if it exists) an 8SVX sound
  310.     file for that particular picture's "illustration" (the actual picture's
  311.     name + the 2 digit illustraion # + ".snd"), then optionally "jumping" to
  312.     the location within the current document "marked" with the '.pm ' (picture
  313.     marker) command.  The syntax of the '.pm ' command is: '.pm i#,<commemt>'.
  314.     Where "i#" is the number of the illustration found in the '.pc ' command.
  315.     The other command is '.pr '; picture routine.  The syntax is: '.pr ON' to
  316.     allow the "jumping" to a '.pm ' marker, which is the default, (or)
  317.     '.pr OFF' which will disable this "jumping" facility..
  318.  
  319.  
  320.  
  321.     Keyboard Shortcuts:
  322.     -------------------
  323.  
  324.       Keyboard shortcuts are basically classified in three areas:
  325.  
  326.         a) General  (G)
  327.  
  328.         b) Limited  (L)
  329.  
  330.         c) Special  (S)
  331.  
  332.  
  333.       General shortcuts are valid as long as an animation is not currently
  334.       being played.
  335.  
  336.       Limited shortcuts are valid whether an animation is playing or not.
  337.  
  338.       Special shortcuts are valid only for an animation (general & limited
  339.       shortcuts do not apply).
  340.  
  341.       Pressing the <HELP> key at anytime, from within 'TVMore',  will display
  342.       the full list of keyboard shortcuts.
  343.  
  344.  
  345.       Keyboard Shortcut  Function                             Type
  346.       -----------------  -----------------------------------  ------------
  347.       R-Amiga A  ......  Begin playing an animation.          G
  348.       R-Amiga C  ......  Toggle 8 Color Screen ON/OFF.        G
  349.       R-Amiga E  ......  Goto End of text file.               G
  350.       R-Amiga F  ......  Find occurance of a word(s).         G
  351.       R-Amiga H  ......  Goto Top of text file.               G
  352.       R-Amiga L  ......  Load text file.                      G
  353.       R-Amiga M  ......  Mark document Place.                 G
  354.       R-Amiga N  ......  Next occurance of word(s).           G
  355.       R-Amiga P  ......  Print entire text file.              G
  356.       R-Amiga Q  ......  Quit (exit) 'TVMore'.                G
  357.       R-Amiga R  ......  Read mode (toggle ON/OFF).           G
  358.       R-Amiga S  ......  Section print.                       G
  359.       R-Amiga W  ......  Word processor edit.                 G
  360.  
  361.       <SPACE>   .......  Next page.                           GL
  362.       <RETURN>  .......  Next line.                           G
  363.       <ARROWS>  .......  Prior line, Next line, Prior page
  364.                          Next page.                           GL
  365.       <ESC>     .......  Quit (exit) 'TVMore'.                G
  366.       '<'       .......  Scroll document left.                G
  367.       '>'       .......  Scroll document right.               G
  368.  
  369.       '<'       .......  Slow down playback.                  S
  370.       '>'       .......  Speed up playback.                   S
  371.       <RETURN>  .......  Full speed plyaback.                 S
  372.       <ESC>     .......  Stop playing animation.              S
  373.  
  374.       <HELP>    .......  Help menu.                           GL
  375.  
  376.       F1-F10    ....... Jump to bookmarks 1-10.               GL
  377.       R-Amiga F1-F10 .. Set a dynamic Book Mark               G
  378.       L-Amiga F1-F10 .. Clear a dynamic Book Mark             G
  379.  
  380.  
  381.  
  382.       (See individual sections for any additional information on the use of
  383.        keyboard shortcuts).
  384.  
  385.  
  386.  
  387.  
  388.                                                                               
  389.  
  390. .bm 05,
  391.   Multimedia:
  392.   -----------
  393.  
  394.     Multimedia combines different medias such as pictures, sounds, music
  395.     and animations into a single presentation element like a storybook (or)
  396.     a visual news article.
  397.  
  398.     There are, currently, 17 multimedia commands available.
  399.  
  400.     Multimedia commands can be stacked one upon another (not to exceed 250
  401.     characters per line) using the "|" delimiter character.  A line begin-
  402.     ing with a '.' command such as '.pf ' is considered to be a command line.
  403.     The last "delimited" section of a command line can be regular text which
  404.     can include ANSI control codes.  However, a normal text line (a line that
  405.     begins with a character other than a '.') cannot be "delimited"; commands
  406.     should always come first.
  407.  
  408.     Note: The ".bm ", ".pc " & ".ac " commands must each begin in text column
  409.     one (1), otherwise these commands will not be recognized by 'TVMore'.
  410.     However, other '.' commands, including text,  can be stacked onto the back
  411.     of these commands.
  412.  
  413.     Note, when using the provided multimedia access commands ('.' commands),
  414.     be sure to strictly follow the provided syntax!  All parameters must be
  415.     of a specific length (specified in the syntax portion of each command)
  416.     otherwise the command will be ignored of fail completely!
  417.  
  418.  
  419.  
  420.     Pictures:
  421.     ---------
  422.  
  423.       Any size or depth of an IFF compatible picture can be used with 'TVMore'
  424.       even if the 'host screen' doesn't support all the required colors.  Care
  425.       should be exercised since HAM pictures have a different layout and their
  426.       appearance could be grossly distorted if displayed on a NON-HAM screen.
  427.  
  428.       Each picture should be in the IFF format (ie. Deluxe Paint).
  429.       A maximum of ten (10) pictures are available at any given time.
  430.  
  431.  
  432.       (Deluxe Paint is copyrighted & trademarked Electronic Arts)
  433.  
  434.                                 ----------
  435.  
  436.       The command to load a picture is ".pf "; picture file.  The syntax is
  437.       as follows; ".pf p#,<picture>".  Where "p#" is a two digit number
  438.       associated with your IFF picture file.
  439.  
  440.       For example:
  441.  
  442.       .pf 01,mypicture|.pf 02,mypicture2
  443.  
  444.       Will load, if it exists, "mypicture", then if it exists, "mypicture2".
  445.       The graphics of "mypicture" can be accessed by reference number "01".
  446.  
  447.       Ten (10) pictures do not seem like alot, however, don't be fooled,
  448.       each picture can have different illustrations within itself that
  449.       can each be accessed seperately using the '.pc ' command.  The maximum
  450.       illustrations allowed are, at the present 100.  The ".pf " command will
  451.       not display an illustration contained within a picture, just load the
  452.       picture into memory & make it available to the '.pc ' command.
  453.  
  454.                                 ----------
  455.  
  456.       To display a picture, use the ".pc " command; picture control.  The
  457.       syntax is: ".pc i#(p#,x#,o#,fx##,fy##,w###,h###)".
  458.  
  459.       For example:
  460.  
  461.       .pc 01(01,10,00,0005,0010,0100,0050)
  462.  
  463.       Will display (starting from the current text line containing the ".pc "
  464.       command and working downward until the height of the illustration is
  465.       displayed) the section of a picture (p#) 1 starting from X=5 (fx###)
  466.       Y=10 (fy###) with a width (and) height of WIDTH=100 HEIGHT=50 (w###
  467.       h###).  This technique allows a variety of illustraions to exists on
  468.       a single picture.  The 'i#' parameter specifies the unique number
  469.       associated with this illustration; these cannot be reused by attempting
  470.       to "clear" them the '.pe ' command.
  471.  
  472.       Note:  Each illustration within a picture can have a different color
  473.       mapping which, after being displayed, can have their colors shown by
  474.       using the '.pn ' command to load the specific palette which matches the
  475.       specialized color mapping of the illustration.
  476.  
  477.       Note: the "o#" is a special parameter to move the entire illustration
  478.       up (or) down a specified number of text lines before it is displayed
  479.       (dynamically offsets '.pc ' command location within the document) and
  480.       normally should always be 0.  This comes in handy when an animation
  481.       & an illustration are to appear on the same text line (since the '.pc '
  482.       command & the '.ac ' command each must begin in text column one (1)
  483.       to be recoginzed by 'TVMore'); one or the other can be "moved" up or
  484.       down a given number of lines.  The maximum negative offset allowed is
  485.       -9 since the size of the parameter is two digits. However this should
  486.       be a very unsual case.
  487.  
  488.                                 ----------
  489.  
  490.       To free up any memory used by a picture, use the ".pe " command.  The
  491.       syntax is as follows; ".pe p#".  Where "p#" is the number of the
  492.       picture that was loaded.
  493.  
  494.       For example:
  495.  
  496.       .pe 01
  497.  
  498.       Will remove picture 1 (p#) (if it was previously loaded) into memory,
  499.       thus freeing up valuable CHIP memory for other document requirements.
  500.  
  501.       Note: Anytime 'TVMore' attempts to display any portion of an illus-
  502.       tration, if the picture associated with the illustration has been freed
  503.       from memory using the '.pe ', 'TVMore' will automatically attempt to
  504.       reload it before displaying the illustration.  This allows the freeing
  505.       of a picture(s) after an illustration(s) has been displayed then only
  506.       reloading it if it's required; memory efficient.
  507.  
  508.  
  509.  
  510.     Sounds:
  511.     -------
  512.  
  513.       'TVMore' supports the playing back of 8SVX format sound files directly
  514.       from disk, the loading of individual sound files then playing them at a
  515.       later time, or syncing them to any specific frame within an animation
  516.       using the '.ss ' (syncronize sound) command.
  517.  
  518.       There are a maximum of ten (10) sound files available for use at any
  519.       given time.
  520.  
  521.                                 ----------
  522.  
  523.       To play a sound file directly from disk use the ".sf " command;
  524.       sound file.  The syntax is: ".sf <sound>".
  525.  
  526.       For example:
  527.  
  528.       .sf growl
  529.  
  530.       Will immediately play the 8SVX sound file "growl" if it exists.
  531.  
  532.                                 ----------
  533.  
  534.       To load a sound file for playback (or syncing) at a later time, use
  535.       the ".sl " command; sound load.  The syntax is: ".sl s#,<sound>".
  536.       Where "s#" is the two digit sound number associated with the "<sound>"
  537.       file.
  538.  
  539.       For example:
  540.  
  541.       .sl 04,myspeach
  542.  
  543.       Will load, if it exists, the 8SVX sound file "myspeach" into memory.
  544.       It will not be played back after it is loaded.  This is done with
  545.       either the '.sp ' (sound play) or the '.ss ' (syncronize sound)
  546.       commands.
  547.  
  548.       Note: Before another sound file can be loaded into memory using the same
  549.       number (s#), any previsously loaded sound file which uses that same
  550.       number must first be freed using the ".sc " (sound clear) command.
  551.  
  552.                                 ----------
  553.  
  554.       To play back a previously loaded 8SVX sound file use the ".sp " command;
  555.       sound play.  The syntax is: ".sp s#".  Where "s#" is the two digit sound
  556.       file number associated with a previously loaded sound.
  557.  
  558.       For exmaple:
  559.  
  560.       .sp 04
  561.  
  562.       Will playback the previously loaded 8SVX sound file #4 which was loaded
  563.       with the '.sl ' command.
  564.  
  565.                                 ----------
  566.  
  567.       To sync a particular sound to a specific frame in an animation use the
  568.       ".ss " command; syncronize sound.  The syntax is: ".ss s#,a#,f#####".
  569.       Where "s#" is the number of a previously loaded sound file (loaded with
  570.       the '.sl ' command), "a#" is number of a previously loaded animation
  571.       (loaded with the '.af ' command), and "f####" is the specific frame #
  572.       within the animation to begin playing back the sound on.
  573.  
  574.       For example:
  575.  
  576.       .ss 04,01,000010
  577.  
  578.       Will begin playback of sound 4 (s#), each time animation segment 1 (a#)
  579.       currently playing and on the 10th frame.
  580.  
  581.       Note:  Before ".ss " should be used, both the animation & sound should
  582.       have been previously loaded (corrosponding to the "s#" & "a#" param-
  583.       eters) using the '.sl ' & '.af ' commands respectively.  The relation-
  584.       ship between an "animation segment" and and the actual animation is like
  585.       the relationship between a picture and an illustration; there can be
  586.       multiple "segments", each accessed seperately, within each each anim-
  587.       ation using the ".ac " command (more on this later)!
  588.  
  589.                                 ----------
  590.  
  591.       To free up the memory used by any previously loaded sound file, use
  592.       the ".sc " command; sound clear.  The syntax is: ".sc s#".  Where
  593.       "s#" is the two digit number of a previously loaded sound file.
  594.  
  595.       For example:
  596.  
  597.       .sc 04
  598.  
  599.       Will free up the memory used by sound #4.
  600.  
  601.  
  602.  
  603.     Palettes:
  604.     ---------
  605.  
  606.       To change an existing palette, or to load a new palette at anytime
  607.       with a document, use the ".pn " command; palette new.
  608.       The syntax is: ".pn p#,<palette>".  Where "p#" is a palette number
  609.       (two digits) ranging from 1-30 (palette #'s below 21 are special, more
  610.       on this later) and "<palette>" is the name of the palette to load.
  611.  
  612.       note: The palette should be an IFF compatible palette or picture file.
  613.  
  614.       For example:
  615.  
  616.       .pn 11,mypalette
  617.  
  618.       Will load (and display) the palette "mypalette" into animation #1's
  619.       palette.
  620.  
  621.       For example:
  622.  
  623.       .pn 04
  624.  
  625.       Will only display the colors used in palette #4 (picture #4's palette)
  626.       if any.
  627.  
  628.       Note: palette #'s 1-10 corrospond to the palette used by pictures 1-10
  629.       (loaded with the '.pf ' command) and palette #'s 11-20 corrospond to
  630.       palettes used by animations 1-10 (loaded with the '.af ' command). All
  631.       other palette #'s (21-30) are not associated with any picture (or)
  632.       animation and can be loaded/reloaded without effecting the appearance
  633.       of an animation or picture.  These are proivided to syncronize palette
  634.       changes on any frame within an animation.  The animations original
  635.       palette will automatically be reset on frame #1 during playback.
  636.  
  637.  
  638.  
  639.     Music:
  640.     ------
  641.  
  642.       'TVMore' supports the loading & playing back of sound tracker music
  643.       modules anytime during the reading of a document.  Each sound tracker
  644.       module is only loaded if it is needed.  This prevents the same sound
  645.       tracker module from being reloaded if it is currently playing.
  646.  
  647.       Note:  If a sound file is played using the ".sp ", ".sf " or synced
  648.       from within an animation (using the '.ss ' command), any currently
  649.       playing sound tracker module will be stopped and any memory used by it
  650.       will be freed up before the sound is played.
  651.  
  652.                                 ----------
  653.  
  654.       The command to load & play a sound tracker module is ".st ".  The
  655.       syntax is: ".st m#,<soundtracker>".  Where "m#" is the two digit
  656.       module #(1-99) and "<soundtracker>" is the name of the sound tracker
  657.       module file to load.  The module number is used only to prevent the
  658.       reloading of the same sound tracker file during document reading if
  659.       it is currently playing.  Only one sound tracker module will exists
  660.       in memory at any given time.  Valid sound tracker modules numbers are
  661.       01-99.
  662.  
  663.       For example:
  664.  
  665.       .st 01,rock-n-roll
  666.  
  667.       Will, load the sound tracker file "rock-n-roll", if it exists, then
  668.       immediately begin playing.
  669.  
  670.                                 ----------
  671.  
  672.       To stop playing and free up any memory used by a sound tracker module,
  673.       use the command ".se "; sound  end.  The syntax is: ".se ".
  674.  
  675.       For example:
  676.  
  677.       .se
  678.  
  679.       Will stop playing any currently playing sound tracker module, then free
  680.       up the memory that it has used.
  681.  
  682.  
  683.  
  684.     Animation:
  685.     ----------
  686.  
  687.       'TVMore' supports the playing back of an ANIM format animation.  Like
  688.       those created using Deluxe Paint (Electronic Arts). Upto ten (10) full
  689.       screen animations can exists in memory at a time, if memory allows.
  690.       However, using another command, you can access upto 100 individual
  691.       "segments" of any individual animation(s).
  692.  
  693.       Note: Before an animation is played, 'TVMore' must allocate the
  694.       required resources such as CHIP memory for the specified animation.
  695.       If 'TVMore' is unable to do this, the animation will not be played.
  696.  
  697.       As of release v1.1, if the last frame of the animation is not known, a
  698.       frame # of 999999 (the maximum allowed) will default to the maximum
  699.       # of frames in the specified animation.  Also, only one animation
  700.       "segment" can be played, on the 'TVMore' window, at a given time.
  701.  
  702.                                 ----------
  703.  
  704.       To load an animation file use the ".af " command; animation file.
  705.       The syntax is: ".af a#,<animation>".  Where "a#" is the two digit number
  706.       associated with the animation file to load, and "<animation>" is the
  707.       name of the animation (ANIM format) file.
  708.  
  709.       For example:
  710.  
  711.       .af 05,myanimation.anim
  712.  
  713.       Will load, if it exists, the ANIM file "myanimation.anim".
  714.  
  715.       Note: This command, like the picture command '.pf ', does not actually
  716.       display the animation, but makes the animation available for access and
  717.       display by the '.ac ' (animation control) command.
  718.  
  719.                                 ----------
  720.  
  721.       To display and animate a portion of a previously loaded animation file
  722.       use the ".ac " command; animation control.
  723.       The syntax is: ".ac i#(a#,t#,o#,fx##,fy##,w###,h###)". Where "i#" is an
  724.       individual animation "segment" found within the animation (a#), and this
  725.       animation "segment" can be found in the animation at X=(fx##) (and)
  726.       Y=(fy##).  Display will begin at text location "t#".  The "o#" parameter
  727.       is a special text line offset and normally should be 0 (same effect as
  728.       within the '.pc ' command.  There can be upto 100 animation "segments".
  729.  
  730.       Note: The animation "segments" cannot be reused by clearing out an
  731.       animation using the '.ae ' command.  "Segments" require very little
  732.       memory.  Each document can have it's own set of animation "segments".
  733.  
  734.       Normally, an animation "segment" will not be automatically played, and
  735.       will be represented by a solid box while reading a document.  To begin
  736.       playing any portion of an animation "segment" at any time, press the
  737.       R-Amiga A keys simultaneously.  This is used to begin playing back
  738.       an animation stopped using the ESC key.  To automatically begin playing
  739.       an animation "segment" from with the document use the '.aq ' & '.ap '
  740.       commands; animation queued & animation play respectively.  Also, to
  741.       play an animation "segment" that is not currently being played, just
  742.       click on it with the left mouse button.
  743.  
  744.       Note: Pressing ESC while playing an animation "segment" will stop
  745.       playing the animation, then pressing ESC again will exist 'TVMore'!
  746.       Be careful!
  747.  
  748.                                 ----------
  749.  
  750.       To automatically begin playing a specific animation "segment" currently
  751.       in the window whenever a "full page" of text has been displayed, use the
  752.       "aq " command; animation queued.  The syntax is: ".aq i#,s#".  Where
  753.       "i#" is the number associated with a previsously defined ('.ac ')
  754.       animation "segment" and "s#" is the speed at which to begin playback.
  755.  
  756.       For example:
  757.  
  758.       .aq 01,15
  759.  
  760.       Will playback animation "segment" 1 (i#) at approximately 4 frames per
  761.       second.  The "s#" parameter specifies the total for 1/60 second
  762.       delay increments; therefore 60 div by 14 = 4.  Larger animations and
  763.       system load may cause noticable slowing during playback.
  764.  
  765.                                 ----------
  766.  
  767.       To begin playing back an animation immediately (whenever this command
  768.       is encountered), use the ".ap " command; animation playback.  The syntax
  769.       is: ".ap i#,s#".  Where "i#" is the individual animation element and
  770.       "s#" is the playback speed (total of 1/60 second delay increments).
  771.  
  772.       For example:
  773.  
  774.       .ap 06,30
  775.  
  776.       Will immediately begin playback of animation "segment" (if it is
  777.       currently being displayed & was previously defined using the '.ac '
  778.       command) at approximately 2 frames per second.
  779.  
  780.                                 ----------
  781.  
  782.       To free up any memory currently being used by an animation, use the
  783.       ".ae " command; animation end.  The syntax is: ".ae a#". Where "a#" is
  784.       the number associated with a previously loaded animation (not animation
  785.       "segment") 1-10.
  786.  
  787.       For example:
  788.  
  789.       .ae 01
  790.  
  791.       Will free up memory used by animation #1.
  792.  
  793.       Note:  Whenever an ".ac " is encountered, and the corrosponding
  794.       animation is not loaded in memory (or) was previously freed, 'TVMore'
  795.       will attempt to reload the animation for display automatically.
  796.  
  797.                                 ----------
  798.  
  799.       To set the syncronized events "delay", "speed" & "palette change" for
  800.       an animation "segment", use the '.as ' command.
  801.       The syntax is: ".as i#,s#,d#,p#,f#####".  Where "i#" is the two digit
  802.       animation "segment" number, "s#" is the two digit plaback speed (01-99),
  803.       "d#" is the two digit delay (01-99) in seconds, "p#" is the palette
  804.       # to change to, and "f#####' is the 6 digit frame number to activate
  805.       these events on.
  806.  
  807.       Note: The syncronized events can only be set for one animation "segment"
  808.       at a time.  However, different events within the same animation
  809.       "segment" can be set as often as desired.
  810.  
  811.       For example:
  812.  
  813.       .as 01,15,00,21,000010|.as 01,00,-1,00,999999
  814.  
  815.       Will set the playback speed at 4 frames per second (60 div by 14 = 4),
  816.       a delay of 4 seconds (on the last frame only), and a palette change
  817.       to #21 when animation "segment" #1, during playback,  reaches the
  818.       10th & last frame respectively.
  819.  
  820.       Note:  Zero values are ignored.  So, a value of 15 (s#) from the first
  821.       '.as ' command is not overridden by the 00 value (s#) found in the
  822.       second '.as ' command.  This allows the setting of multiple events
  823.       for multiple frame(s) within the same animation "segment".
  824.  
  825.       Note:  If the delay is set to -1, then 'TVMore' will stop playing
  826.       the animation on the frame specifyied by "f#####".
  827.  
  828.                                 ----------
  829.  
  830.       To reset all syncronized events, use the '.so ' command; syncronized
  831.       off.  The syntax is as follows: ".so ".
  832.  
  833.       For example:
  834.  
  835.       .so
  836.  
  837.       Will reset the syncronized events for sound, delay, playback speed &
  838.       palette changes.
  839.  
  840.       Note: Any dynamic changes that have occurred to an palette using the
  841.       '.pn ' command, before the animation was played,  will remain in effect.
  842.  
  843.       Note:  The syncronized events are automatically reset when loading
  844.       a new text file (or) whenever an '.ss ' command is encountered where
  845.       the "i#" (animation "segment") is different from the last '.ss '
  846.       command.
  847.  
  848.  
  849.  
  850.  
  851.                                                                               
  852.  
  853. .bm 06,
  854.   Registration:
  855.   -------------
  856.  
  857.  
  858.  
  859.     ------------------------------ Cut Here ---------------------------------
  860.  
  861.     Please find enclosed,11.95$, in check or money order, for each registered
  862.     copy of "TVMore".  I understand that upon receipt of 11.95$, MIKE HURT
  863.     SOFTWARE! will send the current version of 'TVMore'.  Postage and
  864.     handling is included.
  865.  
  866.  
  867.     Send to:
  868.  
  869.     MIKE HURT SOFTWARE!
  870.     c/o 'TVMore'
  871.     8608 Cotswald Drive
  872.     Louisville KY 40258
  873.  
  874.  
  875.     *** PLEASE PRINT ***
  876.  
  877.  
  878.     Company:________________________________________________________
  879.  
  880.        Name:________________________________________________________
  881.  
  882.     Address:________________________________________________________
  883.  
  884.        City:__________________________  State________  Zip:_________
  885.  
  886.     Country:__________________________  Phone:______________________
  887.  
  888.    Computer:__________________________     OS:______________________
  889.  
  890.  
  891.  
  892.  
  893.  
  894.     Please allow 2-3 weeks for delivery.
  895.  
  896.     ------------------------------ Cut Here ---------------------------------
  897.  
  898.  
  899.  
  900.  
  901.                                                                               
  902.  
  903. .bm 07,
  904.   Changes:
  905.   --------
  906.  
  907.     11/20/93 (v1.0 ) :original program.
  908.     12/03/93 (v1.1 ) :o - Added Custom screen option (R-Amiga C).
  909.                       o - Added '.so ' command to reset all syncronized
  910.                           animations events.
  911.                       o - Added '.as ' command to set the speed, delay
  912.                           & palette changes for syncronized animation events.
  913.                       o - Added ANSI support for text.
  914.                       o - Book Marks can be dymacially defined by pressing
  915.                           the R-Amiga F1-F10 keys.
  916.                       o - Added ten (10) user specified palettes (#21-30).
  917.                           These are useful for changing the palette "on
  918.                           the fly" while playing back an animation "segment".
  919.                       o - Place mark files for each document is now supported.
  920.                       o - Other program enhacements & general modifications
  921.                           have been included.
  922.     12/06/93 (v1.2 ) :o - Hyper picture support implemented.  Click on any
  923.                           currently display picture (and) play an 8SVX sound
  924.                           file (or) "jump" to any location within the current
  925.                           document.
  926.                       o - Click on any animation that is not currently being
  927.                           played to begin playing it.
  928.  
  929.  
  930.  
  931.  
  932.                                                                               
  933.  
  934. .bm 08,
  935.   Final Note:
  936.   -----------
  937.  
  938.     Be sure to read the section on MultiMedia as this covers all the commands
  939.     necessary to define and set up your on MultiMedia document.
  940.  
  941.  
  942.  
  943.  
  944.     Good Luck, and enjoy the program.  Mike.